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Upgrade the server model 


This topic describes how to upgrade to a new server model. Before you begin these tasks, be sure you 
have completed the following tasks: 


iF 
2. 


Plan the upgrade 

Upgrade to OS/400 Version 5 Release 2 

You must install the latest resave and cumulative fix (PTF) package of OS/400 V5R2 before you 
upgrade to a new server model. If you are upgrading a partitioned server, you must install this resave 


and cumulative fix (PTF) package of OS/400 V5R2 on all partitions of the source server. For more 
information, see Info APAR 1113365 on the |iSeries and AS/400 Technical Support Web site 


Then to upgrade to a new server model, follow these steps: 


1. 


Prepare to upgrade the server model. 
Choose the procedure that is appropriate for your environment: 


* For nonpartitioned servers, see|“Prepare to upgrade the server model” 
* For partitioned servers, see|Prepare to upgrade the partitioned server model 
“Complete the server model upgrade” on page 5 


Perform the necessary resource management tasks and prepare the target server for production. 


To view or download the PDF version of this topic, select one of the following: 


* |Upgrade the server modell (about 93 KB) 


¢ |Upgrade the partitioned server modell (about 97 KB) 
To view or print other topics related to Upgrades, see 
Prepare to upgrade the server model 


This topic describes how to prepare for the server upgrade. Before you begin these tasks, be sure you 
have completed the necessary |upgrade planning} Then to prepare for the server upgrade, perform the 


following tasks: 


Prepare for the upgrade 


1. 


5. 


Obtain and review the|preventive service planning (PSP) information 


The PSP document for V5R2 upgrades is SF98166. Review this document for the most current 
information on conditions that could affect your upgrade. 


Review the e 
This document provides information about software and hardware changes that could potentially affect 
your system operations. 


View the|Migration Web site ag 


This Web site includes information about the current migration and upgrade paths, a link to relevant 
Redbooks, and information about converting from SPD to PCl-attached I/O. 


Review the Performance Capabilities Reference available on the |Performance Management aed Web 


site. 
This reference provides information about server performance that is useful for customers who plan to 
upgrade their servers and software. 


When your order arrives, contact the service representative and schedule the server model upgrade. 


Prepare the source server 
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Ensure that you have installed latest resave and cumulative fix (PTF) package of OS/400 V5R2 on the 
source server. 


For more information, see Info APAR 1113365 on the|iSeries and AS/400 Technical Support Web site| For 
information on installing OS/400, see|/Upgrade to OS/400 Version 5 Release 2 
1. [Install fixes} (program temporary fixes or PTFs). 


2. 
3. 


Use the information in this topic to put fixes on the source server before upgrading to the target server. 
Verify that all applications are running. 
Perform device configuration cleanup as follows: 


a. Use the Work with Line Descriptions command (WRKLIND) to view and delete unused lines and 
line descriptions. 


b. Use the Work with Device Descriptions command (WRKDEVD) to delete unused device 
descriptions. 


Note: You can use these commands to view and verify that all of the descriptions listed are in use. If 
you are sure one is not in use, delete it. If you are not sure, you should leave it. 


“Remove failed or nonreporting resources” on page 4/that are no longer associated with existing 
hardware. 


Logically remove any configured disk units that will be removed during the upgrade, such as disk units 
in SPD-based expansion units that will be removed (not converted) during the server upgrade. For 
information, see "How to Remove a Disk Unit from an Auxiliary Storage Pool” in Chapter 20. "Working 


with Auxiliary Storage Pools” of the|/Backup and Recovery Guide i . 


Note: Disk units that are not physically removed may be inadvertently added back into the 
configuration during an IPL. 


Ensure that your|console| is set up and ready. 


Use the Retrieve Configuration Source (RTVCFGSRC) command to build a source file member for the 
specified existing line, controller, and device descriptions. You will need this configuration source if any 
configuration objects must be manually changed or re-created. 


Gather performance data 


You can use the performance data you collect from the source server as a base with which to compare 
the target server’s performance after the upgrade is complete. 


Save the entire server using GO SAVE option 21}on a tape drive that is compatible with the tape drive 


on the target server. 
This is vital for recovery should you experience errors when upgrading the server. 


To determine if your tape drives are compatible, see the|Storage Solutions}Web site aes ; 


Document the source server 


To ensure that the source server is fully documented before the upgrade, perform these tasks: 


Ts 


2. 


2 


Use one of the following to document the source server: 


¢ If your country or region supports the Work with Order Information Files (WRKORDINF) command 
and if the installed server is capable of using Electronic Customer Support, do the following: 


a. On the command line, enter WRKORDINF. 


b. On the next display, type option 1 (Send to IBM) next to QMAnnnnn where nnnnn is the serial 
number of the server and press Enter. 


* If you cannot use the Work with Order Information Files (WRKORDINF) command, do the following: 
a. On the command line, enter DSPSFWRSC *PRINT. 
b. Print the spooled file. 


“Print disk configuration status” on page 4/of the server. 
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3. |“Print parity set configuration and status” on page 4 


You can use this information to analyze and plan for disk unit configuration and protection. It can also 
be used to correct any problems that occur during the upgrade. 


4. |“Display, verify, and print hardware resource information” on page 5 


Use the information in this topic to record the hardware resource information so that you can perform 
the necessary resource management after the upgrade is complete. 


5. |Print the system configuration list 


This printout provides details of your current server configuration. 


6. Print the status of all fixes (program temporary fixes or PTFs) on the source server by entering the 
following command: 


DSPPTF LICPGM(*ALL) OUTPUT (*PRINT) 


You can use this information to verify that you have the most current fixes on the source server. 


7. Record the}IPL type and|model of the source server so you can return the server to this mode after the 
upgrade is complete. 


* IPL type = 
e IPL mode = 


Prepare for the service representative 
1. Record the user IDs and passwords for the service representative to use. 
2. Gather the following printouts for the service representative: 
* System configuration list printouts 
* Disk configuration status printouts 
* Parity set configuration and status printout 
* Device descriptions printout 
* Controller descriptions printout 
¢ PTF level printout 
* Description label locations printout 
3. Record the setting for each of the following system values: 
* QAUTOCFG = ___ 
* QIPLTYPE =___ 
* QPFRADJ = ___ 


Then change the values of these settings to the following: 
* QAUTOCFG = 0 

* QIPLTYPE = 2 

* QPFRADJ = 2 


For information on working with system values, see|Compare and update system values 


4. Turn the server over to the service representative. 
This includes giving the service representative the printouts, the user IDs, and passwords that you 
have prepared. 


Now that you have finished preparing for the server upgrade, the next step is for the service representative 
to|“Complete the server model upgrade” on page 5 
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Remove failed or nonreporting resources 


Any hardware resources that were intended to be unassigned should be assigned to a partition in this 
step. These resources can then be unassigned as desired after the expansion unit conversion. To assign 
unassigned I/O resources, complete the following steps on the primary partition: 


Attention: Any hardware problems must be resolved before continuing. I/O resources that are 
nonreporting because they are switched between partitions and currently are not owned by the partition 
you are working in should not be removed by you at this time. Careful planning is required when switched 
I/O is involved. 


1: 


7. 


Enter STRSST on a command line to start system service tools (SST) on the partition. Sign on to SST. 
Note: To use system service tools, you need a valid|service tools user ID 


Select option 1 (Start a Service Tool). 


Select option 7 (Hardware Service Manager (HSM)). 


Select option 4 (Failed and nonreporting hardware resources), and press Enter. Identify and record all 
resources that are switched between partitions. You may need to reassign or rename these resources 
following the expansion unit conversion. 


Type option 4 (remove) to remove any failed or nonreporting resources. If you receive a message 
saying No failed or nonreporting logical hardware resources found, skip to step 6. 


Confirm removal of failed or nonreporting resources. 


Press F6 (Print) to print the system configuration list. 


Print disk configuration status 


To print the disk configuration status of your server, you need security officer authority. Complete the 
following steps to print the disk configuration status: 


ihe 


Enter STRSST on a command line to start system service tools (SST). Sign on to SST. 


Note: To use system service tools, you need a valid|service tools user ID 


Select option 3 (Work with Disk Units) and press Enter. The Work with Disk Units display appears. 


Select option 1 (Display Disk Configuration) and press Enter. The Display Disk Configuration display 
appears. 


Select option 1 (Display Disk Configuration Status) and press Enter. 


At the Display Disk Configuration Status display, print the disk configuration by pressing the Print 
Screen key on your keyboard. 


Page down and repeat until you have printed the entire disk configuration. Ensure that all the disk 
configuration information is printed. 


Record the serial number of the load-source disk unit (unit number 1) for each partition on the server. 


Note: If the server is partitioned, repeat steps 1 through 7 for each partition. Be sure to mark each 
printout for the partition it represents. 


Print parity set configuration and status 
To print the parity set configuration and status of the server, complete the following steps: 


1. 


Enter STRSST on a command line to start system service tools (SST). Sign on to SST. 
Note: To use system service tools, you need a valid|service tools user ID 
Select option 3 (Work with Disk Units) and press Enter. The Work with Disk Units display appears. 


Select option 1 (Display Disk Configuration) and press Enter. The Display Disk Configuration display 
appears. 
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4. Select option 1 (Display Disk Configuration Status) and press Enter. 


5. At the Display Disk Configuration Status display, select option 5 (Display Device Parity Status) and 
press Enter. The Display Device Parity Status display appears. 


6. Print the parity set configuration by pressing the Print Screen key on your keyboard. 


7. Page down and repeat until you have printed the entire parity set configuration. 


Note: If the server is partitioned, repeat these steps from each partition. Be sure to mark each printout for 
the partition it represents. 


Display, verify, and print hardware resource information 

To display, verify, and print the hardware resource information, complete the following steps: 

1. At the OS/400 command line, enter the Work with Hardware Products (WRKHDWPRD) command. 

2. Select option 4 (Display Description Label Locations) and press Enter to display the label information 
associated with the hardware resources. 

3. On the Display Description Label Locations display, verify that the label information about the hardware 
resources is accurate. 

4. Delete the configuration descriptions (also called configuration objects) that are not associated with any 
physical hardware at this time. 

5. Press F17 (Print) to print the description label locations. This information must be given to the service 
representative. 

6. At the OS/400 command line, enter the following commands: 


DSPHDWRSC TYPE(*LWS) OUTPUT (*PRINT) 
DSPHDWRSC TYPE(*STG) OUTPUT (*PRINT) 
DSPHDWRSC TYPE(*CMN) OUTPUT (*PRINT) 
DSPHDWRSC TYPE(*PRC) OUTPUT (*PRINT) 


This creates a report of your hardware and configuration objects. 


Note: If the server is partitioned, repeat these steps from each partition. Be sure to mark the printout for 
the partition it represents. 


Complete the server model upgrade 


This topic describes which tasks of the server upgrade the service representative performs, which tasks 
you perform with the service representative, and which tasks you need to perform. IBM offers fee-based 
services in which the service representative can perform additional upgrade tasks. 


Before you begin these tasks, be sure you have performed the necessary preparation using the procedure 
that is appropriate for your environment: 


* For nonpartitioned servers, see|“Prepare to upgrade the server model” on page 1 
* For partitioned servers, see|Prepare to upgrade the partitioned server model 
To complete the server upgrade, perform these tasks: 


1. |“Perform the server model upgrade” on page 6 


2. Prepare the server for production. 
Choose the procedure that is appropriate for your environment: 


* For nonpartitioned servers, see|“Prepare the server for production” on page 6 
* For partitioned servers, see|Prepare the partitioned server for production 
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Perform the server model upgrade 

The service representative performs the following tasks to upgrade the server: 

* Verifies that your preparation is complete 

¢ Performs the server upgrade 

* Verifies that all server components are functional 

* Prepares any parts that need to be returned to IBM 

¢ Performs any contracted relocation or rearrangement services prior to returning the server to you 
¢ Provides you with the following information, which you will need to return the server to production: 


— LPAR Validation Tool output 
Note: This is only used for a partitioned server. 


— Disk configuration printouts 

— Parity set configuration printout 

— Description label locations printout 

— System configuration list printouts (from HSM) 

— Partition information printouts from the primary partition 
Note: This is only used for a partitioned server. 

— List of hardware resources that were replaced or moved during the conversion (Resource 
Conversions form A880 or equivalent list), provided by the IBM service representative 

— Cable migration worksheet (form A805) for each partition (provided by the service representative) 

¢ Performs normal cleanup tasks 


IBM offers a fee-based service for additional upgrade tasks. For more information, select Migration on the 


Integrated Technology Services «S Web site. 
Now that the server upgrade is complete, your next step is to|“Prepare the server for production” 


Prepare the server for production 
To finish the resource management and prepare your new server for production, perform the following 
steps: 
1. Continue the initial program load (IPL) by selecting option 1 (Perform an IPL) from the IPL or Install 
the System display. 

Notes: 

a. You might see the Add All Disk Units to the System ASP display. You can add the disk units later 
in this procedure. 

b. You might see the system reference code (SRC) A900 2000 on the control panel display of the 
system unit. Or you might receive message CPFO975 Console did not vary on on the console 
display. This SRC and message appear if the QIPLTYPE is set to 2 or if there is no device 
description for the console display. This SRC and message are normal during the upgrade 
procedure. The SRC will disappear when you perform a normal IPL later in the upgrade 
procedure. 

If no workstation on your server is operational when you receive SRC A900 2000, go to[“System] 
reference code (SRC) A900 2000 recovery” on page 8 
2. Sign on to the server as the security officer using the QGECOFR user profile. 
3. At the IPL Options display, enter the correct date and time. Verify that the following values are set as 
indicated: 
Start print writers = N 


Start to system to restricted state = Y 
Define or change system at IPL = Y 


4. At the Define or Change the System at IPL display, select option 3 (System value commands). 
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10. 


11. 


12. 


13. 


14. 


At the System Value Commands display, select option 3 (Work with system values). 

Use the Work System Value Commands display to restore the system values to the settings you 
recorded in step 3 of the Prepare for the service representative procedure in the erepate to usaree) 
After the IPL completes, use the Work with Configuration Status (WRKCFGSTS) command with 


parameters *LIN *ALL to ensure all communications lines are varied off. 


Use the Work with Configuration Status (WRKCFGSTS) command with parameter *DEV to display a 
list of devices. Note that the console is assigned to the QCTL controller. Vary off all devices except 
the display station that you are using for the console. 


Use the Work with Configuration Status (WRKCFGSTS) command with parameters *CTL *ALL to vary 
off all controllers. 


Find the label location information for the source server. Your service representative should have 
returned this to you. 
On this worksheet, the service representative indicates controllers and devices that are in different 


locations than they were on your source server. You must use this information to [Fix hardware] 
[resource flames" on page €lto be able to access the devices on your server. 

Set the server to IPL type B and Normal operating mode. 

To find out how to set these values, see 
Once the server is set to IPL type B and Normal operating mode, follow these steps to stop and start 
the server: 

a. Type PWRDWNSYS on the command line and press F4 (Prompt). 

b. Make sure that you select these options for the PWRDWNSYS command: 


¢ How to end: *CNTRLD 


* Delay time, if *CNTRLD: 3600 (use the default value, in seconds, or the value that you 
consider appropriate given your software and system settings) 


¢ Restart after power down: *YES 
¢ IPL Source: *PANEL 


If SRC A900 2000 appears on the control panel when the IPL completes and you are using 
Operations Console, follow these steps: 


a. Perform an IPL in Manual operating mode on the server to arrive at the dedicated service tools 
(DST) menu. 


To find out how to set the server to manual mode, see|Change your system IPL from the system 
control panel 


b. Then, from the DST main menu, follow these steps to set the console mode system value to 
Operations Console: 


1) Select option 5 (Work with DST environment) and Press Enter. 
) Select option 2, (System devices) and Press Enter. 

3) Select Console mode and Press Enter. 
) 


Depending on your Operations Console configuration, select either Operations Console 
(LAN) or Operations Console (Direct) and Press Enter. 


5) Exit DST. 


c. Continue the IPL to sign on. 
This normal IPL should clear SRC A900 2000. 


If you want to start device parity on any nonconfigured disk units, do it now. To learn how, see 
"Starting Device Parity Protection” in Chapter 21. "Working with Device Parity Protection” of the 


Backup and Recovery Guide ie ‘ 
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15. Perform disk unit management to configure and protect the disks on your server. To do this, you can 
use the Work with Disk Units option from the Dedicated Service Tools display. To learn how, see 
Chapter 19. "Procedures for Configuring Disks and Disk Protection” of the]Backup and Recovery 
(Gui) 

16. |Save the entire server| using GO SAVE option 21. 


17. Generate reports of the hardware and configuration objects by issuing the following commands: 


DSPHDWRSC TYPE(*LWS) OUTPUT (*PRINT) 
DSPHDWRSC TYPE(*STG) OUTPUT (*PRINT) 
DSPHDWRSC TYPE(*CMN) OUTPUT (*PRINT) 
DSPHDWRSC TYPE(*PRC) OUTPUT (*PRINT) 
DSPPTF LICPGM(*ALL) OUTPUT (*PRINT) 


18. |Print a new system configuration list 
19. {Install any additional software|that was part of the original solution plan. 


If you upgraded to a Model 810, 825, 870, or a new Model 890, you may have received additional 
software as a part of a package feature. For information on package features, see the 


[Hardware] "S&> web site. 

20. If you upgraded to a Model 810, 825, 870, or a new Model 890 (excluding Model 890 with feature 
processor cards 0197, 0198, 2487, or 2488), you may need to update the usage limit for OS/400. 
For information on updating the usage limit, see Processor pricing on certain V5R2 models in the 


For information on processor pricing, see Info APAR 1113365 on the 
AS/400 Technical Support Web site 


21. Resume normal operations and verify that all applications run properly. 


22. |Tune server performance. 


Congratulations! You have upgraded your server. 


System reference code (SRC) A900 2000 recovery 
If no workstation on your server is operational, follow these steps: 


Use the control panel to|change your server IPL to manual mode 
Use the power pushbutton] on the control panel to force power down on your server. 
Perform an IPL on your server. 


Sign on as QSECOFR. 

On the IPL or Install the System display, select option 1 (Perform an IPL). 

On the IPL Options display, specify Y for the Define or change the system at IPL prompt. 

On the Define or Change the System at IPL display, select option 3 (System value commands). 
On the System Value Commands display, select option 3 (Work with System Values). 

On the Work with System Values display, type QIPLTYPE in the Position to field. 

In the Option column for the QIPLTYPE system value, type 2 (Change). 


On the Change System Value display for the QIPLTYPE system value, type 2 (Attended IPL, console 
in debug mode). 


Press Enter. You see the Work with System Values display. 
13. Press F3 twice to return to the Define or Change Your System display. 
14. Press F3 (Exit and continue IPL) to continue your IPL. 


rr SO OBNOaPpoNn = 


— aes 


—_ 
aes 


Fix hardware resource names 
Following an upgrade or migration, you may have hardware resources that are in different locations than 
they were on your source server. To fix these hardware resource names, follow these steps: 

1. At the OS/400 command line, enter WRKHDWPRD. 


2. On the Work with Hardware Products display, select option 5 (Change description label locations) and 
press Enter. 
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10. 


11. 


Read the information on the Using Change Label Locations display and press Enter. 

Compare the label information on the display with the source server’s label locations. Label 
information matches if the Label column on the display matches that of the source server. Label 
information does not match if any one of the following is true: 


* The display has label information, but the source server did not have label information in that 
location. 


¢ The source server label information does not match the information found in the Label column on 
the display. 
e »*NONE appears in the Label column on the display, and there is label information for the source 
server. 
Note: When «NONE appears in the Label column for a controller or device that was added or 
upgraded, select option 2 (Change). Then select the correct label description from the list provided. 
If you experience any problems, call your service provider. 
¢ *INCORRECT or «INVALID appears in the Label column. 
This means that the type and model number of the hardware resource information does not match 
the type and model of the configuration description that is currently associated with that resource. 
The server cannot vary on the configuration description. 
¢ «INCORRECT — where the physical location is also ’**’. 
This identifies a controller or device description that no longer has a valid resource on the server. 
If there are any locations where the server label information is not the same as the (physical) label, 
on the Change Description Label Locations display, type 2 in the Opt column for each location that 
requires a label change. Press Enter. The Change Description Label display appears. 
Note: You may make more than one selection at a time, but if More... appears on the bottom of the 
display, do not press Enter. Instead, page forward to select the remaining labels. 
A list of possible label names is shown. To select the label name (on the display) that matches the 
label that was on the source server, type 1 in the Opt column for each location that you want to 
change and press Enter. 
Note: If you cannot find the label (on the display) that matches the label on the source server, contact 
your service representative. 
If you chose to change more than one label, the Change Description Label display appears for the 
next label. A message at the bottom of the display indicates whether the previous change was 
successful. 
For all the labels that need a change, repeat the previous three steps. 
After you change the last label, the Change Description Label Locations display appears with the 


updated information. A message at the bottom of the display indicates whether the last change was 
successful. If More... appears on the bottom of the display, scroll forward to view more information. 


Press the F17 key on the Change Description Label display to request a printout of the new 
information for your records. 

Note: The printout will be in the default output queue for your workstation. You can print it later when 
you vary on your printer devices and start printer writers. 

Verify that the labels on the printout match the labels in the Label column on your source server. If 
you find any errors, go back to step 5 (See|9) and repeat the steps. 

Attention: Do not exchange cards for problem analysis purposes. Card and device serial numbers 
are tied to the server configuration. 
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Printed in U.S.A. 


